Skip to content

Update install scheme pages to reflect selected Cloud URL#286

Merged
aimichelle merged 7 commits intopixie-io:mainfrom
ddelnano:ddelnano/update-cli-install-on-cloud-dropdown
Jul 12, 2024
Merged

Update install scheme pages to reflect selected Cloud URL#286
aimichelle merged 7 commits intopixie-io:mainfrom
ddelnano:ddelnano/update-cli-install-on-cloud-dropdown

Conversation

@ddelnano
Copy link
Copy Markdown
Member

@ddelnano ddelnano commented Jul 11, 2024

Summary: Update install scheme pages to reflect selected Cloud URL

This updates the CLI, Helm and YAML install scheme pages so that the instructions are copy and paste-able. See the screenshots below for the before and after.

Before:
Screen Shot 2024-07-11 at 11 49 27 AM

After:

Screen Shot 2024-07-11 at 2 33 27 PM
Screen Shot 2024-07-11 at 2 33 23 PM

ddelnano added 2 commits July 11, 2024 19:02
Signed-off-by: Dom Del Nano <ddelnano@gmail.com>
(cherry picked from commit 58a19b0)
Signed-off-by: Dom Del Nano <ddelnano@gmail.com>
@ddelnano ddelnano requested a review from a team as a code owner July 11, 2024 19:03
@netlify
Copy link
Copy Markdown

netlify Bot commented Jul 11, 2024

Deploy Preview for docs-px-dev ready!

Name Link
🔨 Latest commit 4acaed2
🔍 Latest deploy log https://app.netlify.com/sites/docs-px-dev/deploys/669176f786db70000895680c
😎 Deploy Preview https://deploy-preview-286--docs-px-dev.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 80 (🟢 up 2 from production)
Accessibility: 76 (no change from production)
Best Practices: 100 (no change from production)
SEO: 85 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify site configuration.

interface Props {
interface Props { }

export const CliDeployInstructions: React.FC<Props> = () => {
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe you can make this a generic TemplatedCodeBlock component which takes the desired commands a prop:

<TemplatedCodeBlock 
    code={`
       # List Pixie deployment options.
        px deploy --help
        # Deploy the Pixie Platform in your K8s cluster (No OLM present on cluster).
        export PL_CLOUD_ADDR=@@`
     }
/>

Let me know if that makes sense/if you need any help with that.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this suggestion! I didn't realize that passing as a prop would be different than accepting the string from within a component's tags.

I've updated this to reflect this and also made changes to the Helm and YAML install pages as well. I would recommend reviewing my later changes commit by commit since I made another few adjustments along the way: renaming @@ to @PLACEHOLDER and renaming PL_ -> PX_.

ddelnano added 4 commits July 11, 2024 20:55
…void MDX library issues

Signed-off-by: Dom Del Nano <ddelnano@gmail.com>
…or drop down

Signed-off-by: Dom Del Nano <ddelnano@gmail.com>
Signed-off-by: Dom Del Nano <ddelnano@gmail.com>
Signed-off-by: Dom Del Nano <ddelnano@gmail.com>
@ddelnano ddelnano changed the title Update CLI install scheme to update URLs based on selected Cloud Update install scheme pages to reflect selected Cloud URL Jul 11, 2024
Comment on lines +109 to 110
px deploy --help \n
# Deploy the Pixie Platform in your K8s cluster (No OLM present on cluster).
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aimichelle leaving the empty lines in this template string caused the following compilation issues:

 ERROR #11321  PLUGIN

"gatsby-plugin-mdx" threw an error while running the onCreateNode lifecycle:

unknown: Unexpected token, expected "{" (1:7)

> 1 | export PX_CLOUD_ADDR=@PLACEHOLDER@
    |        ^
  2 | px deploy --extract_yaml ./ --deploy_key <PIXIE_DEPLOYMENT_KEY> --deploy_olm=false \n
  3 | # Extract YAML (Self-hosting Pixie Cloud).
  4 | px deploy --extract_yaml ./ --deploy_key <PIXIE_DEPLOYMENT_KEY> --dev_cloud_namespace plc \n/home/ddelnano/code/docs.px.dev/content/en/02-installing-pixie/04-install-schemes/02-yaml.md: unknown: Unexpected token, expected "{" (1:7)

> 1 | export PX_CLOUD_ADDR=@PLACEHOLDER@
    |        ^
  2 | px deploy --extract_yaml ./ --deploy_key <PIXIE_DEPLOYMENT_KEY> --deploy_olm=false \n
  3 | # Extract YAML (Self-hosting Pixie Cloud).
  4 | px deploy --extract_yaml ./ --deploy_key <PIXIE_DEPLOYMENT_KEY> --dev_cloud_namespace plc \n

  31 |   const createAndProcessNode = path => {
  32 |     const fileNodePromise = createFileNode(path, createNodeId, pluginOptions).then(fileNode => {
> 33 |       createNode(fileNode);
     |       ^
  34 |       return null;
  35 |     });
  36 |     return fileNodePromise;

File: node_modules/gatsby-source-filesystem/gatsby-node.js:33:7



  SyntaxError: unknown: Unexpected token, expected "{" (1:7)
  > 1 | export PX_CLOUD_ADDR=@  9mPLACEHOLDER@
      |        ^
    2 | px deploy --extract_yaml ./ --deploy_ke  y <PIXIE_DEPLOYMENT_KEY> --deploy_olm=false  [39m \n
    3 | # Extract YAML (Self-hosting   Pixie Cloud).
    4 | px deploy --extract_yaml ./ --deploy_ke  y <PIXIE_DEPLOYMENT_KEY> --dev_cloud_namespace plc   1m\n/home/ddelnano/code/docs.px.dev/content/en/02-installing-pixie/04-instal  l-schemes/02-yaml.md: unknown: Unexpected token, expected "{" (1:7)
  > 1 | export PX_CLOUD_ADDR=@  9mPLACEHOLDER@
      |        ^
    2 | px deploy --extract_yaml ./ --deploy_ke  y <PIXIE_DEPLOYMENT_KEY> --deploy_olm=false  [39m \n
    3 | # Extract YAML (Self-hosting   Pixie Cloud).
    4 | px deploy --extract_yaml ./ --deploy_ke  y <PIXIE_DEPLOYMENT_KEY> --dev_cloud_namespace plc   1m\n
  SyntaxError: unknown: Unexpected token, expected "{" (1:7)
  > 1 | export PX_CLOUD_ADDR=@  9mPLACEHOLDER@
      |        ^
    2 | px deploy --extract_yaml ./ --deploy_ke  y <PIXIE_DEPLOYMENT_KEY> --deploy_olm=false  [39m \n
    3 | # Extract YAML (Self-hosting   Pixie Cloud).
    4 | px deploy --extract_yaml ./ --deploy_ke  y <PIXIE_DEPLOYMENT_KEY> --dev_cloud_namespace plc   1m\n/home/ddelnano/code/docs.px.dev/content/en/02-installing-pixie/04-instal  l-schemes/02-yaml.md: unknown: Unexpected token, expected "{" (1:7)
  > 1 | export PX_CLOUD_ADDR=@  9mPLACEHOLDER@
      |        ^
    2 | px deploy --extract_yaml ./ --deploy_ke  y <PIXIE_DEPLOYMENT_KEY> --deploy_olm=false  [39m \n
    3 | # Extract YAML (Self-hosting   Pixie Cloud).
    4 | px deploy --extract_yaml ./ --deploy_ke  y <PIXIE_DEPLOYMENT_KEY> --dev_cloud_namespace plc   1m\n

Adding \n here was required to keep the line spacing the same. The other thing I tried was adding \n on its own line, but that introduces more spacing than the approach I took as seen in the highlighted text below

Screen Shot 2024-07-11 at 2 40 02 PM

If you have any suggestions here, let me know.

Comment thread content/en/02-installing-pixie/04-install-schemes/02-yaml.md Outdated
Signed-off-by: Dom Del Nano <ddelnano@gmail.com>
@aimichelle aimichelle merged commit f9089d9 into pixie-io:main Jul 12, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants